<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>open_io_device [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_system.html">系统</a> / <a href="toc_system_iodevices.html">输入/输出设备</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">open_io_device</span><span data-if="c" style="display:none;">T_open_io_device</span><span data-if="cpp" style="display:none;">OpenIoDevice</span><span data-if="dotnet" style="display:none;">OpenIoDevice</span><span data-if="python" style="display:none;">open_io_device</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">open_io_device</span><span data-if="c" style="display:none;">T_open_io_device</span><span data-if="cpp" style="display:none;">OpenIoDevice</span><span data-if="dotnet" style="display:none;">OpenIoDevice</span><span data-if="python" style="display:none;">open_io_device</span></code> — Open and configure an I/O device.
</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>open_io_device</b>( :  : <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, <a href="#IODeviceName"><i>IODeviceName</i></a>, <a href="#GenParamName"><i>GenParamName</i></a>, <a href="#GenParamValue"><i>GenParamValue</i></a> : <a href="#IODeviceHandle"><i>IODeviceHandle</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_open_io_device</b>(const Htuple <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const Htuple <a href="#IODeviceName"><i>IODeviceName</i></a>, const Htuple <a href="#GenParamName"><i>GenParamName</i></a>, const Htuple <a href="#GenParamValue"><i>GenParamValue</i></a>, Htuple* <a href="#IODeviceHandle"><i>IODeviceHandle</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>OpenIoDevice</b>(const HTuple&amp; <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const HTuple&amp; <a href="#IODeviceName"><i>IODeviceName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>, HTuple* <a href="#IODeviceHandle"><i>IODeviceHandle</i></a>)</code></p>
<p>
<code>void <a href="HIODevice.html">HIODevice</a>::<b>HIODevice</b>(const HString&amp; <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const HTuple&amp; <a href="#IODeviceName"><i>IODeviceName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
<p>
<code>void <a href="HIODevice.html">HIODevice</a>::<b>HIODevice</b>(const char* <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const HTuple&amp; <a href="#IODeviceName"><i>IODeviceName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
<p>
<code>void <a href="HIODevice.html">HIODevice</a>::<b>HIODevice</b>(const wchar_t* <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const HTuple&amp; <a href="#IODeviceName"><i>IODeviceName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
<p>
<code>void <a href="HIODevice.html">HIODevice</a>::<b>OpenIoDevice</b>(const HString&amp; <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const HTuple&amp; <a href="#IODeviceName"><i>IODeviceName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
<p>
<code>void <a href="HIODevice.html">HIODevice</a>::<b>OpenIoDevice</b>(const char* <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const HTuple&amp; <a href="#IODeviceName"><i>IODeviceName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
<p>
<code>void <a href="HIODevice.html">HIODevice</a>::<b>OpenIoDevice</b>(const wchar_t* <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, const HTuple&amp; <a href="#IODeviceName"><i>IODeviceName</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>OpenIoDevice</b>(<a href="HTuple.html">HTuple</a> <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#IODeviceName"><i>IODeviceName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#IODeviceHandle"><i>IODeviceHandle</i></a>)</code></p>
<p>
<code>public <a href="HIODevice.html">HIODevice</a>(string <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#IODeviceName"><i>IODeviceName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
<p>
<code>void <a href="HIODevice.html">HIODevice</a>.<b>OpenIoDevice</b>(string <a href="#IOInterfaceName"><i>IOInterfaceName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#IODeviceName"><i>IODeviceName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>open_io_device</b>(<a href="#IOInterfaceName"><i>iointerface_name</i></a>: str, <a href="#IODeviceName"><i>iodevice_name</i></a>: str, <a href="#GenParamName"><i>gen_param_name</i></a>: Sequence[str], <a href="#GenParamValue"><i>gen_param_value</i></a>: Sequence[Union[int, float, str]]) -&gt; HHandle</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">open_io_device</span><span data-if="c" style="display:none">open_io_device</span><span data-if="cpp" style="display:none">OpenIoDevice</span><span data-if="com" style="display:none">OpenIoDevice</span><span data-if="dotnet" style="display:none">OpenIoDevice</span><span data-if="python" style="display:none">open_io_device</span></code> opens and configures the chosen
I/O device interface for the specific device. The device interface
is specified by the base name of the underlying library and passed
to <a href="#IOInterfaceName"><i><code><span data-if="hdevelop" style="display:inline">IOInterfaceName</span><span data-if="c" style="display:none">IOInterfaceName</span><span data-if="cpp" style="display:none">IOInterfaceName</span><span data-if="com" style="display:none">IOInterfaceName</span><span data-if="dotnet" style="display:none">IOInterfaceName</span><span data-if="python" style="display:none">iointerface_name</span></code></i></a>. The interface library will be loaded
dynamically when configuring the first specific device for this
device interface. The specific device itself is addressed by a name
passed to <a href="#IODeviceName"><i><code><span data-if="hdevelop" style="display:inline">IODeviceName</span><span data-if="c" style="display:none">IODeviceName</span><span data-if="cpp" style="display:none">IODeviceName</span><span data-if="com" style="display:none">IODeviceName</span><span data-if="dotnet" style="display:none">IODeviceName</span><span data-if="python" style="display:none">iodevice_name</span></code></i></a>. Available names can be queried by
<a href="query_io_interface.html"><code><span data-if="hdevelop" style="display:inline">query_io_interface</span><span data-if="c" style="display:none">query_io_interface</span><span data-if="cpp" style="display:none">QueryIoInterface</span><span data-if="com" style="display:none">QueryIoInterface</span><span data-if="dotnet" style="display:none">QueryIoInterface</span><span data-if="python" style="display:none">query_io_interface</span></code></a>. The device can be configured by the
parameters <a href="#GenParamName"><i><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></i></a> and <a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>. A
reference to the device instance is returned in
<a href="#IODeviceHandle"><i><code><span data-if="hdevelop" style="display:inline">IODeviceHandle</span><span data-if="c" style="display:none">IODeviceHandle</span><span data-if="cpp" style="display:none">IODeviceHandle</span><span data-if="com" style="display:none">IODeviceHandle</span><span data-if="dotnet" style="display:none">IODeviceHandle</span><span data-if="python" style="display:none">iodevice_handle</span></code></i></a>. If the instance of the device is not needed
any more, it should be released and closed via 该算子
<a href="close_io_device.html"><code><span data-if="hdevelop" style="display:inline">close_io_device</span><span data-if="c" style="display:none">close_io_device</span><span data-if="cpp" style="display:none">CloseIoDevice</span><span data-if="com" style="display:none">CloseIoDevice</span><span data-if="dotnet" style="display:none">CloseIoDevice</span><span data-if="python" style="display:none">close_io_device</span></code></a>.
</p>
<p>Having opened a specific device, a transmission channel can be
opened by calling <a href="open_io_channel.html"><code><span data-if="hdevelop" style="display:inline">open_io_channel</span><span data-if="c" style="display:none">open_io_channel</span><span data-if="cpp" style="display:none">OpenIoChannel</span><span data-if="com" style="display:none">OpenIoChannel</span><span data-if="dotnet" style="display:none">OpenIoChannel</span><span data-if="python" style="display:none">open_io_channel</span></code></a>. Values on the I/O channel
can be read and written by 该算子s <a href="read_io_channel.html"><code><span data-if="hdevelop" style="display:inline">read_io_channel</span><span data-if="c" style="display:none">read_io_channel</span><span data-if="cpp" style="display:none">ReadIoChannel</span><span data-if="com" style="display:none">ReadIoChannel</span><span data-if="dotnet" style="display:none">ReadIoChannel</span><span data-if="python" style="display:none">read_io_channel</span></code></a> and
<a href="write_io_channel.html"><code><span data-if="hdevelop" style="display:inline">write_io_channel</span><span data-if="c" style="display:none">write_io_channel</span><span data-if="cpp" style="display:none">WriteIoChannel</span><span data-if="com" style="display:none">WriteIoChannel</span><span data-if="dotnet" style="display:none">WriteIoChannel</span><span data-if="python" style="display:none">write_io_channel</span></code></a> on an opened transmission channel,
afterwards.
</p>
<p>An opened device instance can be reconfigured by using 该算子s
<a href="set_io_device_param.html"><code><span data-if="hdevelop" style="display:inline">set_io_device_param</span><span data-if="c" style="display:none">set_io_device_param</span><span data-if="cpp" style="display:none">SetIoDeviceParam</span><span data-if="com" style="display:none">SetIoDeviceParam</span><span data-if="dotnet" style="display:none">SetIoDeviceParam</span><span data-if="python" style="display:none">set_io_device_param</span></code></a> and <a href="get_io_device_param.html"><code><span data-if="hdevelop" style="display:inline">get_io_device_param</span><span data-if="c" style="display:none">get_io_device_param</span><span data-if="cpp" style="display:none">GetIoDeviceParam</span><span data-if="com" style="display:none">GetIoDeviceParam</span><span data-if="dotnet" style="display:none">GetIoDeviceParam</span><span data-if="python" style="display:none">get_io_device_param</span></code></a>.
</p>
<p>Please check the directory <code>doc/html/reference/io</code> for
documentation about your specific I/O device interface, where all
supported device specific parameters are listed.
</p>
<h2 id="sec_attention">注意</h2>
<p>On Windows Systems, error dialog boxes from the operating system can occur
when dependency modules of the interface are not found, e.g., the according
SDK was not installed. The occurrence of the error boxes can be controlled by
setting Windows' Error Mode. Please refer to the description of SetErrorMode
within the Windows MSDN documentation.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<p>This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.</p>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="IOInterfaceName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">IOInterfaceName</span><span data-if="c" style="display:none">IOInterfaceName</span><span data-if="cpp" style="display:none">IOInterfaceName</span><span data-if="com" style="display:none">IOInterfaceName</span><span data-if="dotnet" style="display:none">IOInterfaceName</span><span data-if="python" style="display:none">iointerface_name</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">HALCON I/O interface name.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>[]</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'ADLINK-DAQPilot'</span><span data-if="c" style="display:none">"ADLINK-DAQPilot"</span><span data-if="cpp" style="display:none">"ADLINK-DAQPilot"</span><span data-if="com" style="display:none">"ADLINK-DAQPilot"</span><span data-if="dotnet" style="display:none">"ADLINK-DAQPilot"</span><span data-if="python" style="display:none">"ADLINK-DAQPilot"</span>, <span data-if="hdevelop" style="display:inline">'ADLINK-EOS'</span><span data-if="c" style="display:none">"ADLINK-EOS"</span><span data-if="cpp" style="display:none">"ADLINK-EOS"</span><span data-if="com" style="display:none">"ADLINK-EOS"</span><span data-if="dotnet" style="display:none">"ADLINK-EOS"</span><span data-if="python" style="display:none">"ADLINK-EOS"</span>, <span data-if="hdevelop" style="display:inline">'Advantech'</span><span data-if="c" style="display:none">"Advantech"</span><span data-if="cpp" style="display:none">"Advantech"</span><span data-if="com" style="display:none">"Advantech"</span><span data-if="dotnet" style="display:none">"Advantech"</span><span data-if="python" style="display:none">"Advantech"</span>, <span data-if="hdevelop" style="display:inline">'Contec'</span><span data-if="c" style="display:none">"Contec"</span><span data-if="cpp" style="display:none">"Contec"</span><span data-if="com" style="display:none">"Contec"</span><span data-if="dotnet" style="display:none">"Contec"</span><span data-if="python" style="display:none">"Contec"</span>, <span data-if="hdevelop" style="display:inline">'Hilscher-cifX'</span><span data-if="c" style="display:none">"Hilscher-cifX"</span><span data-if="cpp" style="display:none">"Hilscher-cifX"</span><span data-if="com" style="display:none">"Hilscher-cifX"</span><span data-if="dotnet" style="display:none">"Hilscher-cifX"</span><span data-if="python" style="display:none">"Hilscher-cifX"</span>, <span data-if="hdevelop" style="display:inline">'Interface'</span><span data-if="c" style="display:none">"Interface"</span><span data-if="cpp" style="display:none">"Interface"</span><span data-if="com" style="display:none">"Interface"</span><span data-if="dotnet" style="display:none">"Interface"</span><span data-if="python" style="display:none">"Interface"</span>, <span data-if="hdevelop" style="display:inline">'Linux-GPIO'</span><span data-if="c" style="display:none">"Linux-GPIO"</span><span data-if="cpp" style="display:none">"Linux-GPIO"</span><span data-if="com" style="display:none">"Linux-GPIO"</span><span data-if="dotnet" style="display:none">"Linux-GPIO"</span><span data-if="python" style="display:none">"Linux-GPIO"</span>, <span data-if="hdevelop" style="display:inline">'NIDAQmx'</span><span data-if="c" style="display:none">"NIDAQmx"</span><span data-if="cpp" style="display:none">"NIDAQmx"</span><span data-if="com" style="display:none">"NIDAQmx"</span><span data-if="dotnet" style="display:none">"NIDAQmx"</span><span data-if="python" style="display:none">"NIDAQmx"</span>, <span data-if="hdevelop" style="display:inline">'OPC_Classic'</span><span data-if="c" style="display:none">"OPC_Classic"</span><span data-if="cpp" style="display:none">"OPC_Classic"</span><span data-if="com" style="display:none">"OPC_Classic"</span><span data-if="dotnet" style="display:none">"OPC_Classic"</span><span data-if="python" style="display:none">"OPC_Classic"</span>, <span data-if="hdevelop" style="display:inline">'OPC_UA'</span><span data-if="c" style="display:none">"OPC_UA"</span><span data-if="cpp" style="display:none">"OPC_UA"</span><span data-if="com" style="display:none">"OPC_UA"</span><span data-if="dotnet" style="display:none">"OPC_UA"</span><span data-if="python" style="display:none">"OPC_UA"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="IODeviceName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">IODeviceName</span><span data-if="c" style="display:none">IODeviceName</span><span data-if="cpp" style="display:none">IODeviceName</span><span data-if="com" style="display:none">IODeviceName</span><span data-if="dotnet" style="display:none">IODeviceName</span><span data-if="python" style="display:none">iodevice_name</span></code></b> (input_control)  </span><span>tuple <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">I/O device name.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>[]</p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></b> (input_control)  </span><span>string-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Dynamic parameter names.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>[]</p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamValue" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></b> (input_control)  </span><span>string-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[Union[int, float, str]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string / </span><span data-if="hdevelop" style="display:inline">integer / </span><span data-if="hdevelop" style="display:inline">real)</span><span data-if="dotnet" style="display:none"> (<i>string</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">double)</span><span data-if="cpp" style="display:none"> (<i>HString</i> / </span><span data-if="cpp" style="display:none">Hlong / </span><span data-if="cpp" style="display:none">double)</span><span data-if="c" style="display:none"> (<i>char*</i> / </span><span data-if="c" style="display:none">Hlong / </span><span data-if="c" style="display:none">double)</span></span>
</div>
<p class="pardesc">Dynamic parameter values.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>[]</p>
</div>
  <div class="par">
<div class="parhead">
<span id="IODeviceHandle" class="parname"><b><code><span data-if="hdevelop" style="display:inline">IODeviceHandle</span><span data-if="c" style="display:none">IODeviceHandle</span><span data-if="cpp" style="display:none">IODeviceHandle</span><span data-if="com" style="display:none">IODeviceHandle</span><span data-if="dotnet" style="display:none">IODeviceHandle</span><span data-if="python" style="display:none">iodevice_handle</span></code></b> (output_control)  </span><span>io_device <code>→</code> <span data-if="dotnet" style="display:none"><a href="HIODevice.html">HIODevice</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the opened I/O device.</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
* Select a suitable i/o device interface of name IOInterfaceName
query_io_interface (IOInterfaceName, 'io_device_names', DeviceNames)
open_io_device (IOInterfaceName, DeviceNames[0], [], [], IODeviceHandle)
query_io_device (IODeviceHandle, [], 'io_channel_names.digital_input', \
                 ChannelInputNames)
open_io_channel (IODeviceHandle, ChannelInputNames[0], [], [], \
                 IOChannelHandle)
read_io_channel (IOChannelHandle, Value, Status)
</pre>
<h2 id="sec_result">结果</h2>
<p>如果参数均有效，算子
<code><span data-if="hdevelop" style="display:inline">open_io_device</span><span data-if="c" style="display:none">open_io_device</span><span data-if="cpp" style="display:none">OpenIoDevice</span><span data-if="com" style="display:none">OpenIoDevice</span><span data-if="dotnet" style="display:none">OpenIoDevice</span><span data-if="python" style="display:none">open_io_device</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  If necessary an
exception is raised. In this case, an extended error information may be
set and can be queried with 该算子 <a href="get_extended_error_info.html"><code><span data-if="hdevelop" style="display:inline">get_extended_error_info</span><span data-if="c" style="display:none">get_extended_error_info</span><span data-if="cpp" style="display:none">GetExtendedErrorInfo</span><span data-if="com" style="display:none">GetExtendedErrorInfo</span><span data-if="dotnet" style="display:none">GetExtendedErrorInfo</span><span data-if="python" style="display:none">get_extended_error_info</span></code></a>.
</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="query_io_interface.html"><span data-if="hdevelop" style="display:inline">query_io_interface</span><span data-if="c" style="display:none">query_io_interface</span><span data-if="cpp" style="display:none">QueryIoInterface</span><span data-if="com" style="display:none">QueryIoInterface</span><span data-if="dotnet" style="display:none">QueryIoInterface</span><span data-if="python" style="display:none">query_io_interface</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="set_io_device_param.html"><span data-if="hdevelop" style="display:inline">set_io_device_param</span><span data-if="c" style="display:none">set_io_device_param</span><span data-if="cpp" style="display:none">SetIoDeviceParam</span><span data-if="com" style="display:none">SetIoDeviceParam</span><span data-if="dotnet" style="display:none">SetIoDeviceParam</span><span data-if="python" style="display:none">set_io_device_param</span></a></code>, 
<code><a href="get_io_device_param.html"><span data-if="hdevelop" style="display:inline">get_io_device_param</span><span data-if="c" style="display:none">get_io_device_param</span><span data-if="cpp" style="display:none">GetIoDeviceParam</span><span data-if="com" style="display:none">GetIoDeviceParam</span><span data-if="dotnet" style="display:none">GetIoDeviceParam</span><span data-if="python" style="display:none">get_io_device_param</span></a></code>, 
<code><a href="open_io_channel.html"><span data-if="hdevelop" style="display:inline">open_io_channel</span><span data-if="c" style="display:none">open_io_channel</span><span data-if="cpp" style="display:none">OpenIoChannel</span><span data-if="com" style="display:none">OpenIoChannel</span><span data-if="dotnet" style="display:none">OpenIoChannel</span><span data-if="python" style="display:none">open_io_channel</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
